Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 4 - Dialog Manager Reference / Dialog Manager Functions

Manipulating Items in Dialog and Alert Boxes /

GetDialogItemAsControl

NEW WITH THE APPEARANCE MANAGER

Returns the control handle for a dialog item in an embedding hierarchy.

pascal OSErr GetDialogItemAsControl (
                     DialogPtr inDialog,
                     SInt16 inItemNo,
                     ControlHandle *outControl);

inDialog

A pointer to a dialog structure.

inItemNo

A number corresponding to the position of an item in the dialog box's item list.

outControl

A pointer to a control handle that, on output, will refer to the embedded control.

function result

A result code; see "Result Codes". The Control Manager result code errItemNotControl indicates that the dialog item is not a control.

DISCUSSION

When an embedding hierarchy is established, GetDialogItemAsControl produces a handle to the embedded controls (except Help items). It should be used instead of GetDialogItem when an embedding hierarchy is established.

SEE ALSO

"Appearance Manager Gestalt Selector Constants".